home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 4 / Mac Giga-ROM 4.0 - 1993.toast / FILES / BBS / TABBY:FIDO / AreaFix 1.6.sit / About AreaFix… next >
Text File  |  1989-12-06  |  12KB  |  303 lines
  1.  
  2.                         About AreaFix/RRH…
  3.  
  4. [For notes on the latest version of AreaFix, please read the attached
  5. AreaFix News document. It will list changes which are not reflected in
  6. this main documentation. In case of disagreement between this document
  7. and AreaFix News, trust the latter.]
  8.  
  9. Shamelessly modeled on a MSDOS program called AreaFix, this Tabby
  10. utility is designed to automate Echo distribution. With it, boards can
  11. remotely turn on and turn off Echoes they receive from Tabby/Red Ryder
  12. Host, and they can get listings of currently available Echoes.
  13.  
  14.                      From the User’s Perspective
  15.  
  16. Its operation is quite simple. You create a private NetMail message
  17. addressed to AreaFix at a valid node address. You can type AreaFix any
  18. way you want, as long as you don’t embed spaces or tabs or random
  19. letters in the name -- AreaFix, AREAfix, areafix and AREAFIX all work.
  20. Just spell it right. Send this message to an AreaFix-equipped board with
  21. which you share Echoes (it will work with Red Ryder Host, MSDOS and even
  22. Mansions [though Mansions wants you to address it to AFIX]). You and the
  23. node addressed must agree on a password. Put this password in the
  24. “Subject” field of the message, along with two optional switches:
  25.  
  26. -L requests a text file listing and documenting Echo areas. This text
  27. file is prepared by the sysop, and offers illuminating descriptions of
  28. mysteries such as COMP.BINARIES.MAC. If the sysop is lazy and hasn’t
  29. written this text file, you’ll get nothing.
  30.  
  31. -Q requests a list of currently available Echoes. This list includes all
  32. entries in the Tabby Areas.BBS file, except for the UNKNOWN section (not
  33. too much demand for Unidentified Echo Objects). If an Echo is already
  34. received by eight nodes -- Tabby’s maximum -- it will not be shown in
  35. this listing. (You can also get a listing of available Echoes by putting
  36. an asterisk [*] or a question mark on a single line in the body of the
  37. message -- I included this for Mansions compatibility).
  38.  
  39. The body of the message consists of names of Echo areas. If a name
  40. appears by itself, AreaFix presumes it’s to be added to your
  41. distribution. If it’s preceded by a minus sign, AreaFix removes it from
  42. your distribution. If you absent-mindedly put a plus in front of the
  43. Echo name, no problem -- AreaFix ignores the plus sign and adds the area
  44. anyway.
  45.  
  46. Here is the format of a sample message, along with some notes:
  47.  
  48. -------------------------------------------------------------------
  49.  
  50. Msg #31514 in *Net Private* Created on 07/04/89 at 07:44:51
  51. To: AREAFIX [Private], From: ERIK SELBERG
  52. Via address: 15/31
  53. Subject: MooHaHa -Q -L
  54.  
  55. -SPACE
  56. MACNOV
  57. RRH
  58.  
  59. -------------------------------------------------------------------
  60.  
  61. The only entry in this message which is critical in terms of caps and
  62. lower case is the password -- it must exactly match the password you and
  63. the addressee agree on. MOOHAHA won’t be recognized. The rest --
  64. switches, area names and the name AreaFix can be any case -- AreaFix
  65. will treat them all as if they were capitalized.
  66.  
  67. With this message, Erik is requesting a text listing explaining
  68. available Echo sections [-L] and a listing of all active and available
  69. sections [-Q]. In addition, he wants to “turn on” the MACNOV and RRH
  70. Echoes, and “turn off” the SPACE Echo.
  71.  
  72. AreaFix will send him back three messages. The first one is caused by
  73. the -L switch. It lists and explains the Echo sections, like so:
  74.  
  75. -------------------------------------------------------------------
  76.  
  77. Msg #31515 in *Net Private* Created on 07/04/89 at 07:45:52
  78. To: ERIK SELBERG [Private], From: AreaFix on 102/863
  79. Via address: 102/863
  80. Subject: Response to AreaFix Request
  81.  
  82. TBLGPGEN  General interest Echo carried by Southern California boards
  83. TBLGPHEL  Help & Tips Echo carried by Southern California boards
  84. TBLGPBUY  Buy & Sell Echo carried by Southern California boards
  85. ECHOMAC   High-volume national Macintosh Echo from FidoNet
  86. ALTERMAC  National Macintosh Echo via AlterNet
  87. MACDEV    National Macintosh Developers Echo from FidoNet
  88. MACHYPE   National HyperCard Echo from FidoNet
  89. MACUK     Macintosh users in the United Kingdom
  90. TABBY     Tabby Echo
  91. RRH       Red Ryder Host Echo
  92. SCAMS     Southern California Macintosh Sysops Echo
  93. SOCAL     Southern California Fido Sysops Echo
  94. MACCOMM   Macintosh Communications Echo
  95. MUSIC     National Music Echo
  96. WRITING   National Echo for Writers
  97. MACFSALE  National Macintosh For Sale Echo
  98. U_MACSRC  UseNet Macintosh Source
  99. U_MACSYS  UseNet Macintosh System
  100. U_MACDIG  UseNet MacDigest
  101. U_MACHYP  UseNet HyperCard
  102. U_MACPRG  UseNet Macintosh Programmers
  103. MACNOV    Macintosh Novice Programmers
  104. COMP.BINARIES.MAC UseNet BinHex file exchange
  105. MACFILES  Macintosh File Exchange Echo chaired by Ed Edell
  106. SPACE     National Space Echo
  107.  
  108. --- AreaFix/RRH Version 1.0
  109.  
  110. -------------------------------------------------------------------
  111.  
  112. The econd one, caused by the -Q switch, looks like this:
  113.  
  114. -------------------------------------------------------------------
  115.  
  116. Msg #31516 in *Net Private* Created on 07/04/89 at 07:46:53
  117. To: ERIK SELBERG [Private], From: AreaFix on 102/863
  118. Via address: 102/863
  119. Subject: Response to AreaFix Request
  120.  
  121. The following is a list of Echoes currently available on this board:
  122.      
  123. TBLGPGEN
  124. TBLGPHEL
  125. TBLGPBUY
  126. ECHOMAC
  127. ALTERMAC
  128. MACDEV
  129. MACHYPE
  130. MAC
  131. TABBY
  132. RRH
  133. SCAMS
  134. SOCAL
  135. MACCOMM
  136. MUSIC
  137. WRITING
  138. MACFSALE
  139. U_MACSRC
  140. U_MACSYS
  141. U_MACDIG
  142. U_MACHYP
  143. U_MACPRG
  144. MACNOV
  145. SPACE
  146.  
  147. --- AreaFix/RRH Version 1.0
  148.  
  149. -------------------------------------------------------------------
  150.  
  151. The third one, caused by the changes requested in the text of the
  152. message, looks like this:
  153.  
  154. -------------------------------------------------------------------
  155.  
  156. Msg #31517 in *Net Private* Created on 07/04/89 at 07:47:54
  157. To: ERIK SELBERG [Private], From: AreaFix on 102/863
  158. Via address: 102/863
  159. Subject: Response to AreaFix Request
  160.  
  161. You are currently sharing the following Echoes with this board (an
  162. asterisk indicates that you are the feed):
  163.      
  164. * ALTERMAC
  165.   U_MACSRC
  166.   U_MACSYS
  167.   U_MACDIG
  168.   U_MACHYP
  169.   MACNOV
  170.   RRH
  171.      
  172. At your request, the following Echo feeds were discontinued:
  173.      
  174.   SPACE
  175.      
  176. At your request, the following Echo feeds were added:
  177.      
  178.   MACNOV
  179.   RRH
  180.  
  181. --- AreaFix/RRH Version 1.0
  182.  
  183. -------------------------------------------------------------------
  184.  
  185. Notes:
  186.  
  187. You do not need to use both, or either of the two “Subject” switches.
  188. Your password is fine all by itself.
  189.  
  190. If you request discontinuing an Echo for which you are the source (first
  191. listing in a line of nodes in the Areas.bbs file), the request will be
  192. ignored -- take it up directly with the sysop.
  193.  
  194. If you want to get a list of Echoes which you are now receiving from a
  195. remote BBS, just request that it add an Echo which you are already
  196. getting. This will leave your status unchanged, but will send you a
  197. message summarizing your current feeds.
  198.  
  199. AreaFix is a bit loose in its report format. If you request adding an
  200. Echo which you already receive, AreaFix will dutifully claim to have
  201. added the Echo in its message back to you. In fact, it doesn’t change
  202. the Areas.bbs distribution a bit if you ask for something you’re already
  203. getting.
  204.  
  205. I’ve tried to make AreaFix fairly flexible in terms of reading message
  206. text. If it can’t match a line against an existing section, it ignores
  207. the line. In comparing the lines of the message against entries in the
  208. Areas.BBS file, every message line is stripped of leading and following
  209. spaces and tabs, and leading plus and minus signs, which gives AreaFix
  210. compatibility with other AreaFix schemes, including that of Mansions.
  211. For additional Mansions compatibility, AreaFix also recognizes an
  212. asterisk alone on a message text line as synonymous with the -Q switch.
  213.  
  214.  
  215.                      From the Sysop’s Perspective
  216.  
  217. You need to use an up-to-date Generic Import program along with AreaFix.
  218. Any version of TImport higher than 1.32 will work (1.32 was supposed to
  219. work, but had a small problem).
  220.  
  221. Configure AreaFix with two items of information: the name of your BBS
  222. application (this will probably never be used, but please do fill it in)
  223. and a toggle: Message to Sysop. If this is enabled, AreaFix will send
  224. you a message anytime it makes a change to the Areas.BBS file. If you
  225. don’t select this option, AreaFix will do its work quietly.
  226.  
  227. Tell the Import program that AreaFix is to be used as the AreaFix
  228. application (TImport has a configuration dialog for this) and put a copy
  229. of AreaFix at the same level as TabbyNet and her many friends --
  230. including the Import and Export utilities.
  231.  
  232. YOU DO NOT NEED TO ENTER AREAFIX AS A NETMAIL EVENT! TImport or Import
  233. will automatically launch AreaFix when they spot a message with an
  234. AreaFix address. TImport will also alter the launch.next file so that
  235. AreaFix returns to TImport when it’s done, so TImport can process any
  236. messages left by AreaFix in the Generic Import file.
  237.  
  238. Passwords for AreaFix can be created in two ways:
  239.  
  240. <1> You can use Tabby Maint to set up passwords for any nodes which you
  241.     will allow to use AreaFix. Tabby 2.0 limits these passwords to 6
  242.     characters or less in length. If you use Tabby Maint, then the
  243.     password file, which is called Password, is operative on all
  244.     communications with that other board.
  245.  
  246. <2> You can use a text editor to create a passwords list. The format for
  247.     a password file is identical to the Tabby Password format:
  248.  
  249.     NodeID <tab> Password <return>
  250.     NodeID <tab> Password <return>
  251.     
  252.     and so on (no spaces, just tabs separating the NodeID from the
  253.     password, and a carriage return after every line).
  254.  
  255.     An actual file looks like this:
  256.  
  257.     107/563    KingEdward
  258.     102/823    DaddyGee
  259.  
  260. If you want to use passwords longer than 6 characters, set up a text
  261. file as indicated in Technique <2> and save it in the Tabby folder under
  262. the name AreaPass (or you can save a copy of your Password file as
  263. AreaPass, then lengthen the actual passwords). AreaFix looks for this
  264. file *before* it tries to use the Password file, and uses the contents
  265. of AreaPass in preference to the Tabby Password file.
  266.  
  267. If you use Tabby Maint to set up passwords for any nodes which you will
  268. allow to use AreaFix, both you and the other node agree on a password,
  269. and both of you enter the password to use in all communications with the
  270. other node. AreaFix uses the Tabby Password file to get this information
  271. (unless there is a AreaPass file, as described in the previous
  272. paragraph). If an AreaFix message is sent by a board without a password,
  273. AreaFix will notify the board sysop to get a password.
  274.  
  275. If you want to be a good, industrious sysop, create a text file called
  276. AreaFix.List in your Tabby folder. In it, describe the Echo areas on
  277. your board. This is the information which will be sent when someone uses
  278. the -L option in AreaFix. If you don’t have such a file, no list will be
  279. sent.
  280.  
  281. As I mentioned earlier in the documentation, if you get a request
  282. discontinuing an Echo from the source for that Echo (the first listing
  283. in the Areas.bbs file), the request will be ignored -- that’s something
  284. that should be handled by humans, not automatons.
  285.  
  286. Many thanks to Mike Lininger, who supplied me with AreaFix documentation
  287. from the MSDOS world, to Erik Selberg, who has been over-the-top helpful
  288. in the realm of Pascal programming, and to Bruce Gerson, who has made
  289. some excellent suggestions.
  290.  
  291. AreaFix/RRH was written in LightSpeed Pascal. AreaFix/RRH is © 1989 by
  292. Pete Johnson and all rights are, as they say, reserved. It is free for
  293. non-commercial distribution.
  294.  
  295.        Pete Johnson
  296.        July 20, 1989
  297.  
  298. (As this document is written, my board is down due to CPU and hard disk
  299. failure. I’m not sure when it will be back up. In the meantime, you can
  300. reach me on GEnie as PETERJ, or send messages to me in care of The
  301. Bear's Lair, Fido node 102/823. I keep in touch with the RRH and Tabby
  302. Echoes via The Bear's Lair, so you can also reach me in those Echoes.)
  303.